+ [IAD-MIGRATION-124] Добавление кодо ошибок с других спецификаций домена IAD

Наполнение мастер-данных базовыми кодами ошибок ИИ и СУБД симулятора

Author

Services Task & Simulation Framework Documentation

Published

July 13, 2026

Краткая карточка задачи

Репозиторий / Компонент: auth-service (База auth_db, контур SECURITY).
Целевая СУБД: PostgreSQL v15+.
Ссылка на Метод: Метод регистрации
Статус: Готово к реализации

Инструкция по шагам: Выполнить стартовую SEED-миграцию для наполнения реестра каноническими кодами ошибок, возникшими в рамках пересборки 14 топиков и 22 sequence-диаграмм архитектурного манифеста.

Спецификация вилок исключений и обработки ошибок

При аутентификации система обрабатывает ошибки безопасности на Шаге 5, не раскрывая наружу, какая именно часть учетных данных была неверной. Это защищает контур от перебора логинов злоумышленниками.

1. Ошибка: Неверный логин или пароль (HTTP 401 Unauthorized)

Вызывается на Шаге 5, если хэш пароля не совпал, либо если указанный email полностью отсутствует в базе данных пользователей PostgreSQL.

Заголовки ответа (Response Headers):
- Content-Type: application/json
Тело ответа (Response Body):

{
  "error_code": "ERR-INVALID-CREDENTIALS",
  "message": "Неверный логин или пароль. Доступ к системе отклонен.",
  "details": {
    "action": "Prompt user to re-enter credentials or trigger password recovery flow."
  }
}

2. Ошибка валидации формата email (HTTP 422 Unprocessable Entity)

Возвращается на Шаге 4 бэкенд-шлюзом FastAPI, если переданная строка в поле username не соответствует валидному синтаксису адреса электронной почты.

{
  "error_code": "ERR-VALIDATION-FAILED",
  "message": "Передан некорректный формат логина (требуется валидный email).",
  "details": [
    {
      "loc": ["body", "username"],
      "msg": "value is not a valid email address",
      "type": "value_error.email"
    }
  ]
}